Skip to main content
GET
/
fulfillment
/
{id}
Get fulfillment option
curl --request GET \
  --url https://api.example.com/fulfillment/{id}
{
  "data": {
    "id": "delivery",
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Delivery",
    "type": "DELIVERY",
    "status": "ACTIVE"
  }
}
Returns one fulfillment option by external id. Use this endpoint after the customer selects a fulfillment mode to load its name, type code, and status for the storefront.
Requires a Fire spark access token obtained through token exchange.

​
Path parameters

ParameterRequiredDescription
idYesExternal fulfillment identifier. Alphanumeric characters, _, and - only. 1–64 characters.

​
Request

curl "https://firespark.vercel.app/api/storefront/v1/fulfillment/delivery" \
  -H "Authorization: Bearer ACCESS_TOKEN"

​
Response

The response wraps a single fulfillment object in data. The shape matches list fulfillment options. 
{
  "data": {
    "id": "delivery",
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Delivery",
    "type": "DELIVERY",
    "status": "ACTIVE"
  }
}

​
Fulfillment fields

See list fulfillment options for the full schema.
Use the fulfillment type when loading stores and checking which locations expose that mode. Store responses nest operational rules under fulfillment.<type>.

​
Error responses

StatusDescription
401Missing or invalid access token.
403Token does not have access to this fulfillment option.
404No fulfillment option found with the given id.